| Package | hl7.fhir.us.davinci-ra |
| Resource Type | OperationDefinition |
| Id | ra.evaluate-measure |
| FHIR Version | R4 |
| Source | http://hl7.org/fhir/us/davinci-ra/https://build.fhir.org/ig/HL7/davinci-ra/OperationDefinition-ra.evaluate-measure.html |
| URL | http://hl7.org/fhir/us/davinci-ra/OperationDefinition/ra.evaluate-measure |
| Version | 2.1.0 |
| Status | draft |
| Date | 2025-07-24T18:33:11+00:00 |
| Name | RAEvaluateMeasure |
| Title | Evaluate Measure |
| Realm | us |
| Authority | hl7 |
| Description | The ra.evaluate-measure operation is used to evaluate Digital Condition Category and obtain the results. |
| Type | true |
| Kind | operation |
| CapabilityStatement | |
| ra-reporting-server | Risk Adjustment Reporting Server Capability Statement |
No resources found
Note: links and images are rebased to the (stated) source
Generated Narrative: OperationDefinition ra.evaluate-measure
URL: [base]/Measure/$ra.evaluate-measure
URL: [base]/Measure/[id]/$ra.evaluate-measure
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | periodStart | 1..1 | date | The start of a clinical evaluation period. The periodStart and periodEnd parameters will be compared with the clinical evaluation period ( | ||
| IN | periodEnd | 1..1 | date | The end of a clinical evaluation period. | ||
| IN | subject | 1..1 | string (reference) | Subject will be a reference to either Patient (US Core Patient) or Group (Patient Group). Must provide either Patient/123 or Group/123, cannot simply provide 123. If only 123 is provided, then the operation would not know if it is a Patient reference or a Group reference. | ||
| IN | measureId | 0..* | id | The id of a Measure resource for risk adjustment model, e.g., CMS HCC v24 | ||
| IN | measureIdentifier | 0..* | string (token) | The business identifier of a Measure resource for risk adjustment model, e.g., CMS HCC v24. | ||
| IN | measureUrl | 0..* | canonical | This the URL of a Measure resource for risk adjustment model, e.g., CMS HCC v24 | ||
| OUT | return | 0..1 | Bundle | The $ra.evaluate-measure operation will always return one Parameters whether the subject is a single patient or a group of patients. Risk Adjustment Coding Gap Report Bundle for a patient is in a |
{
"resourceType": "OperationDefinition",
"id": "ra.evaluate-measure",
"text": {
"status": "generated",
"div": "<!-- snip (see above) -->"
},
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
"valueInteger": 1
},
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
"valueCode": "cqi"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
"valueCode": "draft"
}
],
"url": "http://hl7.org/fhir/us/davinci-ra/OperationDefinition/ra.evaluate-measure",
"version": "2.1.0",
"name": "RAEvaluateMeasure",
"title": "Evaluate Measure",
"status": "draft",
"kind": "operation",
"date": "2025-07-24T18:33:11+00:00",
"publisher": "HL7 International / Clinical Quality Information",
"contact": [
{
"telecom": [
{
"system": "url",
"value": "http://www.hl7.org/Special/committees/cqi"
}
]
}
],
"description": "The ra.evaluate-measure operation is used to evaluate Digital Condition Category and obtain the results.",
"jurisdiction": [
{
"coding": [
{
"system": "urn:iso:std:iso:3166",
"code": "US",
"display": "United States of America"
}
]
}
],
"code": "ra.evaluate-measure",
"base": "http://hl7.org/fhir/OperationDefinition/Measure-evaluate-measure",
"resource": [
"Measure"
],
"system": false,
"type": true,
"instance": true,
"parameter": [
{
"name": "periodStart",
"use": "in",
"min": 1,
"max": "1",
"documentation": "The start of a clinical evaluation period. The periodStart and periodEnd parameters will be compared with the clinical evaluation period (`MeasureReport.period.start` and `MeasureReport.period.end`) of a [Risk Adjustment Coding Gap MeasureReport](StructureDefinition-ra-measurereport.html) available on the Server. The MeasureReport will be returned if there is an overlap of the two periods.",
"type": "date"
},
{
"name": "periodEnd",
"use": "in",
"min": 1,
"max": "1",
"documentation": "The end of a clinical evaluation period.",
"type": "date"
},
{
"name": "subject",
"use": "in",
"min": 1,
"max": "1",
"documentation": "Subject will be a reference to either Patient ([US Core Patient](http://hl7.org/fhir/us/core/STU3.1.1/StructureDefinition-us-core-patient.html)) or Group ([Patient Group](StructureDefinition-ra-patient-group.html)). Must provide either Patient/123 or Group/123, cannot simply provide 123. If only 123 is provided, then the operation would not know if it is a Patient reference or a Group reference.",
"type": "string",
"searchType": "reference"
},
{
"name": "measureId",
"use": "in",
"min": 0,
"max": "*",
"documentation": "The id of a Measure resource for risk adjustment model, e.g., CMS HCC v24",
"type": "id"
},
{
"name": "measureIdentifier",
"use": "in",
"min": 0,
"max": "*",
"documentation": "The business identifier of a Measure resource for risk adjustment model, e.g., CMS HCC v24.",
"type": "string",
"searchType": "token"
},
{
"name": "measureUrl",
"use": "in",
"min": 0,
"max": "*",
"documentation": "This the URL of a Measure resource for risk adjustment model, e.g., CMS HCC v24",
"type": "canonical"
},
{
"name": "return",
"use": "out",
"min": 0,
"max": "1",
"documentation": "The $ra.evaluate-measure operation will always return one [Parameters](https://www.hl7.org/fhir/parameters.html) whether the subject is a single patient or a group of patients. [Risk Adjustment Coding Gap Report Bundle](StructureDefinition-ra-measurereport-bundle.html) for a patient is in a `Parameters.parameter` element. A Risk Adjustment Coding Gap Report Bundle contains the Risk Adjustment Coding Gap Reports for the same patient. For example, if a Group has 10 valid patients, then a [Parameters](https://www.hl7.org/fhir/parameters.html) will contain 10 `Parameters.parameter`elements, with each `Parameters.parameter` for a unique patient.",
"type": "Bundle"
}
]
}